
,;0 



Artificial intelligence Project— RX£ ai^.,li^;^eiii^tatidh Center 

Memo 9 

EXPLANATION OP BIG "P M AS OF MARCH 20, 1959 
ay Se R. Rucjsell 



ERROR is a routine to provide a common location for all 
routines. Its calling sequence is: 

sxd Terror, k 

TSX #ERR0R+1,4 
The above is normally followed immediately by up to 20 registers 
of BCD remarks terminated by a word of l 8 s. This may be left 
out* however- 

ERROR prints out the remark, if any, the location of the 
TSX that entered error, restores the console except for the AC 
overflow, and transfers to the user's error routine specified by 
the calling sequence of SETUP, 

All the error stops in the programs in the package use this 
routine o 

ERROR uses W0T(MISPH2) for printing, and must be set up by 

O S3TUP* 
SETUP 

Sets the error return for ERROR, sets up the public push- 
down list and writes the free storage list. Its calling sequence 
is: 

TSX £SETUP,4 
LPDL,,LPRE 

TERROR . 

where: 

LPDL is the desired length of the push-down list. 
LPRE is the length of the FREE storage list. 
TERROR is the user's error routine. 

The address of the user's error program is "torgd^n ERROR, 
the public push-down list extends upward from 40,000^and the free 
storage extends upward from immediately above the public push- 
down list* 

The start of the public push-down list is set by the symbol 

O PPDL in save,, 
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SAVE and UHSAVE 

SAFE inserts the contents of a specified number of registers 
ending at a specified location in the public push-down list, and 
indexes the public push-down list* 

UNSAVE takes a specified number of words off the public push- 
down list and stores them in consecutive registers ending with a 
specified register. The calling sequences for SAVE and UNSAVE 
are identical: 

TSX SAVE,4 
REa+V*N 

or 

TSX UNSAVE^ 
RBG+1,,N 
Where REG is the last register to be effected and N is the 
number of registers to be effected • 

The size of the public push-down is set by SETUP* 

Registers AR01-AR0 10 

These registers are used for the argument of functions . 
By convention, the first argument is stored in the AC, the 
second argument in the MQ and the succeeding arguments, up to 
a total of ten, are stored in ARQ3-ARG10* 15 bit quantities 

occupy only the decrement c 

ARG1 or AR02 are not used for this, but they are provided 

for convenience in indexing of certain debugging routines. 
ARGli similarly is a symbol that may be used to index through 
the arguments, 

PRINT 

PRINT is an almost-function of one argument. It prints 
the list that is its argument in restricted external notation. 
It prints null sublists as blanks, and if its argument is 
zero, it prints a blank line. It will be modified soon to print 
objects that are floating point numbers. 

If an object has no print name, an error atop will occur. 

PRINT uses MISPH2 and hence is governed by its sense switch 
settings. If switch 3 ia up, output will be tape 2. If down, 
output is online. 
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READ 

READ is a pseudo-function that reads in lists in restricted 
external notation from cards {SW 1 down) or tape * (SW 1 up). 
It only treats the first 72 column 'of a card, but ignores card 
boundrles. The value of READ is the read in list. Only letters 
and numbers may be used in lists tc be read in by read. The 
characters £, 2* and x are used for punctuation, but any other 
special characters will cause an error stop. A blank or series 
of blanks are interpreted as a comma. Redundant combinations 
such as A. » It. * etCo are believed to work correctly in all 
cases, but no exhaustive tests of this have been made. READ 
will convert until the parentheses count out, and stop on next 
character, so that several lists may be on one card, or a list 
may run over to several cards. 

PRINAR 

PRINAR is a subroutine for debugging purposes that prints 
a specified number of arguments, starting at the AC. It is 
transparent to all registers except the P and Q bits of 
the AC. 

Its calling sequence is 

TSX #PRINAR,4 

N 
BCD 2name 
where N is the number of arguments to be printed. 

. The 2 words of BCD are used at a label for the printing. 

CONC is included in the package but it is incorrect and 
has been superceded by append. 

RDB is a new and more flexible basic read routine, but, 
at present it lacks higher routines to make it work. 

All the object lists are placed &t the end of the package. 

CONVENTIONS FOR HANP-COMPXUBP J*ISP FP8CTI0N3 
All functions are transparent to the index registers and 
end with TRA 1,4. 

The arguments of a function are given in sequence in the 
O AC, the MQ, and the unheaded symbolic locations AR03, AR04, o.. 
ARG10* The values of functions arc in the AC on return. 
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The following conventions hs^:::^o»-^B^_ 
values: 36-bit quantities qcmm ^^^^■^$> 
la the AC the sign 1b used for the 
quantities occupy the decrement part of a 
quantities occupy the low-order bit of .the: 
stands for truth , and a for a 




r "^£: ; 



The use of SAVE and UNSAVK are des 




aeaos 4 and 6. 
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